package com.t.bricks.bussiness.controller.examination;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;

import java.util.List;
import java.util.Map;

import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import com.t.bricks.bussiness.controller.common.BaseController;
import com.t.bricks.bussiness.db.entity.examination.Examination;
import com.t.bricks.bussiness.service.examination.ExaminationService;
import com.t.bricks.model.MsgEmity;
import com.t.bricks.utils.modules.web.FindByPageParam;

/**
 * 考题控制层
 * 继承BaseController可直接实现通用方法,三个泛型代表:业务类、实体类、查询类
 * 通用业务类CommonService已经包含常用功能,使用自定义ExaminationService(需实现)可覆盖通用方法或扩展业务功能
 * 通用查询类可以直接使用Map,否则使用自定义ConditionExamination(需实现)
 * @author HuangXinBian
 * @DateTime 2021年12月13日 16:12:08
 */
@RestController
@Api(value="考题", tags={"考试系统-考题操作接口"})
@RequestMapping("/examination/")
public class ExaminationController extends BaseController<ExaminationService<Examination>, Examination, Map<String, Object>> {
	
	/**
	 * 控制操作,首位9不参与用6个数代表开关,0为不限制,1为限制
	 * 6个数的控制分别是:删除、修改、查询、导出、统计、步骤值可逆
	 * 其中前5个为'是否仅创建者可操作'后续为其它控制开关
	 */
	protected int enableTag = 9000000;

	/**
	 * 设置 检查待新增内容是否存在重复数据(多字段组合重复即重复)集合
	 * @return 返回的集合将覆盖父类的checkRepeatCombination成员,若返回null则不进行重复校验
	 */
	@Override
	protected List<String> setCheckRepeatCombination() {
		return null;//例:Arrays.asList("sName", "sCreator");
	}

	/**
	 * 设置 检查待新增内容是否存在重复数据(单独字段重复即重复)集合
	 * @return 返回的集合将覆盖父类的checkRepeatAlone成员,若返回null则不进行重复校验
	 */
	@Override
	protected Map<String, Integer> setCheckRepeatAlone() {
		return null;
	}

	/**
	 * 删除数据
	 * @param iVersion
	 * @param id 记录编号
	 * @return MsgEmity
	 */
	@RequestMapping(method={RequestMethod.POST}, value="/del")
	@Override
	public MsgEmity del(Integer iVersion, String id) {
		return super.del(iVersion, id);//直接使用父类中定义的方法,否则使用examinationService.del(iVersion, sId);
	}

	/**
	 * 新增数据
	 * @param examination 考题实体对象
	 * @return MsgEmity
	 */
	@ApiOperation(value="新增数据", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/add")
	@Override
	public MsgEmity add(@RequestBody Examination examination) {
		return super.add(examination);//直接使用父类中定义的方法,否则使用examinationService.add(examination);
	}

	/**
	 * 修改数据
	 * @param examination 考题实体对象
	 * @return MsgEmity
	 */
	@ApiOperation(value="修改数据", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/edit")
	@Override
	public MsgEmity edit(@RequestBody Examination examination) {
		return super.edit(examination);//直接使用父类中定义的方法,否则使用examinationService.edit(examination);
	}

	/**
	 * 根据记录编号查询符合分页数据的某条记录
	 * @param id 记录编号
	 * @return MsgEmity
	 */
	@ApiOperation(value="根据记录编号查询符合分页数据的某条记录", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/find/page/row")
	@Override
	public MsgEmity findByPageRow(String id) {
		return super.findByPageRow(id);//直接使用父类中定义的方法,否则使用examinationService.findByPageRow(id);
	}

	/**
	 * 查询分页数据
	 * @param findByPageParam 分页查询条件组合类
	 * 结构参考: {"page": 分页请求信息对象, "orders": 排序信息对象集合, "sLikeStr": 全文检索, "condition": 查询条件对象}
	 * @return MsgEmity 返回查询结果
	 */
	@ApiOperation(value="查询分页数据", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/find/page")
	@Override
	public MsgEmity findByPage(@RequestBody FindByPageParam<Map<String, Object>> findByPageParam) {//findByPage(@RequestBody FindByPageParam<ConditionExamination> findByPageParam)
		return super.findByPage(findByPageParam);//直接使用父类中定义的方法,否则使用 examinationService.findByPage(findByPageParam.getPage(), findByPageParam.getOrders(), findByPageParam.getsLikeStr(), findByPageParam.getCondition());
	}

	/**
	 * 查询树形结构数据
	 * @return MsgEmity
	 */
	//[start]
	@ApiOperation(value="查询树形结构数据", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/find/tree")
	@Override
	public MsgEmity findByTree() {
		return super.findByTree();//直接使用父类中定义的方法,否则使用原始方式examinationService.findByTree();
	}
	
	/**
	 * 清理指定用户的缓存
	 * @param sUser 用户编号
	 * @return MsgEmity
	 */
	//[start]
	@ApiOperation(value="清理指定用户的缓存", notes="若不提供用户编号则删除所有用户的缓存")
	@RequestMapping(method={RequestMethod.POST}, value="/clear/cache")
	@Override
	public MsgEmity clearCache(String sUser) {
		return super.clearCache(sUser);//直接使用父类中定义的方法,否则使用原始方式examinationService.clearCache(sUser);
	}

	/**
	 * 查询组结构数据
	 * @param sGroupName
	 * @return
	 */
	@ApiOperation(value="查询组结构数据", response=Examination.class)
	@RequestMapping(method={RequestMethod.POST}, value="/find/group")
	@Override
	public MsgEmity findByGroup(String sGroupName) {
		return super.findByGroup(sGroupName);//直接使用父类中定义的方法,否则使用原始方式ExaminationService.findByGroup(sGroupName);
	}

	//---------------------------- 自动生成代码结束 ----------------------------//

}
